home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / cback1.zip / CALLBACK.DOC < prev    next >
Text File  |  1991-12-01  |  16KB  |  439 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                       Callback Verification Version 1.52
  25.                     Copyright (C) 1991 By Axis Developments
  26.                           Programed By Robert Goshko
  27.  
  28.                          Calanost BBS - (403)474-5579
  29.                               FidoNet - 1:342/29
  30.                               RBBSNet - 8:990/107
  31.                            CompuServe - 70740,3640
  32.  
  33.  
  34.  
  35.      Callback V1.52                                                  Page 2
  36.  
  37.                                Table of Contents
  38.                             -----------------------
  39.  
  40.      1.0 Introduction . . . . . . . . . . . . . . . . . . . . . . .  Page 3
  41.         1.1 Kudos . . . . . . . . . . . . . . . . . . . . . . . . .  Page 3
  42.         1.2 Warrenty. . . . . . . . . . . . . . . . . . . . . . . .  Page 3
  43.         1.3 FOSSIL Note . . . . . . . . . . . . . . . . . . . . . .  Page 3
  44.  
  45.      2.0 SetUp. . . . . . . . . . . . . . . . . . . . . . . . . . .  Page 4
  46.         2.1 Configuration Commands. . . . . . . . . . . . . . . . .  Page 4
  47.  
  48.      3.0 The Command Line . . . . . . . . . . . . . . . . . . . . .  Page 6
  49.  
  50.      4.0 Interfacing Callback . . . . . . . . . . . . . . . . . . .  Page 6
  51.         4.1 With Maximus-CBCS . . . . . . . . . . . . . . . . . . .  Page 7
  52.         4.2 With RBBS-PC 17.x and up. . . . . . . . . . . . . . . .  Page 8
  53.         4.3 With XBBS 1.17. . . . . . . . . . . . . . . . . . . . .  Page 8
  54.         4.4 Other BBS Systems . . . . . . . . . . . . . . . . . . .  Page 8
  55.  
  56.      5.0 SysOp Keys . . . . . . . . . . . . . . . . . . . . . . . .  Page 9
  57.  
  58.      6.0 Conclusion . . . . . . . . . . . . . . . . . . . . . . . .  Page 9
  59.  
  60.      7.0 Registration . . . . . . . . . . . . . . . . . . . . . . .  Page 9
  61.  
  62.  
  63.  
  64.      Callback V1.52                                                  Page 3
  65.  
  66.      1.0 Introduction
  67.  
  68.           Welcome to the Callback user verification program.  I wrote this
  69.      program mainly because of all the callback verifiers that exist, I was
  70.      never able to find one that would work with anything above COM2 on a
  71.      standard IBM system.  Since my BBS used an internal modem on COM4, I
  72.      could never get one to work.  With a good knowledge of C and Ray
  73.      Gwinn's FOSSIL developers guide in hand, I give you this.
  74.  
  75.           Callback was writen and tested with Ray Gwinn's double aught
  76.      buckshot driver version 1.24.  The two other FOSSIL's I know about are
  77.      BNU and OpusCOMM, and I cannot say if it will work with either one.
  78.  
  79.      1.1 Kudos
  80.  
  81.           There a a few people I would like to thank and they are as
  82.      follows:
  83.  
  84.      Raymond L. Gwinn - Developer of the FOSSIL specification and one heck
  85.                         of a FOSSIL driver.
  86.  
  87.      Sean M. Pratz - SysOp of Wrigley Field.  Supplied the internal
  88.                      structure of the JUMPER.DAT file, and offical beta
  89.                      tester.
  90.  
  91.      Scott J. Dudley - Creator of Maximus-CBCS.  Supplied the internal
  92.                        structure of the DOOR.SYS, CHAIN.TXT, and
  93.                        CALLINFO.BBS files.
  94.  
  95.      Don Hazlewood - SysOp of Satellite RBBS-PC.  Tested the built in
  96.                      RBBS-PC interface.
  97.  
  98.      1.2 Warrenty
  99.  
  100.           This program and it's supporting files will take up room on your
  101.      harddrive or floppy disks until you delete it.
  102.  
  103.      1.3 FOSSIL Note
  104.  
  105.           Callback is totally FOSSIL driven, so if you do not currently
  106.      have a FOSSIL driver installed on your system, you will need one.
  107.  
  108.           Callback does not initalize the FOSSIL, it just continues using
  109.      it at the rate that the BBS set it to.
  110.  
  111.  
  112.  
  113.      Callback V1.52                                                  Page 4
  114.  
  115.      2.0 SetUp
  116.  
  117.           Create a directory and unzip the files in to the directory you
  118.      wish to use.  There are 4 files included in the package that you
  119.      must have all in one place, they are as follows:
  120.  
  121.           CALLBACK.EXE - The actual program
  122.           CALLBACK.CFG - The configuration file
  123.           INFO.TXT     - Operating instructions for the user
  124.           BADNUMS.TXT  - Numbers the you don't want called
  125.  
  126.           Those are all the default filenames, the last two (INFO.TXT and
  127.      BADNUMS.TXT can be changed via the configuration file.  The fifth and
  128.      final file that will be made the first time someone is verified is on
  129.      called VERIFY.TXT.  This will contain the names of the users that have
  130.      been verified and their phone numbers.  Callback will not verify two
  131.      people with the same phone number.
  132.  
  133.      2.1 Configuration Commands
  134.  
  135.           The configuration file CALLBACK.CFG must reside in the smae
  136.      subdirectory as the executable.  This file is a flat ASCII file so you
  137.      can edit it with Qedit or any other text editor.  Don't use a word
  138.      proccesor, because many of them insert control characters and other
  139.      garbage into a file and that will confuse the executable.
  140.  
  141.           Any line starting with a semi-colon (;) will be treated as a
  142.      comment, and will be skiped.
  143.  
  144.      PORT <FOSSIL port #>
  145.  
  146.           This command word specifies which FOSSIL port the program will
  147.      use for serial I/O.  The FOSSIL port must be initalized to the BAUD,
  148.      parity, word length and stop bits prior to running the program.  The
  149.      FOSSIL port number is ONE LESS than the COM port number, COM1 is
  150.      FOSSIL port 0, etc...
  151.  
  152.      VERIFIED <File Name>
  153.  
  154.           This command allows you to specify the file that Callback will
  155.      write the names and phone number of users to, for it's own use.  For
  156.      logging information see the LOG command word.
  157.  
  158.      BADFILE <File Name>
  159.  
  160.           This command specifies which file contains the number that you do
  161.      not want your computer to call.  The number in this file support the
  162.      wildcard ?, for blocking numbers like 911, you would enter ???911????.
  163.      Since the area code and postfix are irrelevent, any number begining
  164.      with 911, will not be dialed.
  165.  
  166.  
  167.  
  168.      Callback V1.52                                                  Page 5
  169.  
  170.      INFOFILE <File Name>
  171.  
  172.           This command word tells Callback to display this file to the
  173.      caller after the welcome and before any information is asked of the
  174.      caller.  It is a flat ASCII file with no ANSI codes.
  175.  
  176.      AREACODE <Three digit area code>
  177.  
  178.           This lets Callback know what your local area code is.  Callback
  179.      will not verify people who are calling long distance, because I am not
  180.      wealthy enough to support this, and I don't know any SysOp that is.
  181.  
  182.      AREANAME <Name>
  183.  
  184.           This is the name of the area that your area code covers, my area
  185.      code of 403 covers the province of Alberta so I have Alberta listed as
  186.      the area name.
  187.  
  188.      DIAL <ATDT or ATDP>
  189.  
  190.           This is the dial command used by your modem, ATDT for touch tone
  191.      dialing, or ATDP for pulse tone dialing.
  192.  
  193.      BBSNAME <Name of BBS>
  194.  
  195.           This command set your BBS name display within Callback and to the
  196.      user.
  197.  
  198.      SYSOPNAME <SysOp's Name>
  199.  
  200.           This specifies the SysOp of the BBS, or the person you may have
  201.      delegated to take care of any user verification problems.
  202.  
  203.      (optional) LOG <Path\File Name>
  204.  
  205.           The LOG command word is used to specify a file that Callback will
  206.      log any error's or verifications to.  The log format used is the same
  207.      a BinkleyTerm and Maximus.  This command word may also have a complete
  208.      path to a log file after it (eg. LOG E:\MAX\MAX.LOG).  Log entries
  209.      will look like this:
  210.  
  211.           ! 26 Nov 14:56:41 CBAK Verification of USER : TEST USER1
  212.           ! 26 Nov 14:57:43 CBAK TEST USER1 Verified at xxxyyyzzzz
  213.  
  214.  
  215.  
  216.      Callback V1.52                                                  Page 6
  217.  
  218.      3.0 The Command Line
  219.  
  220.           The command line call for Callback includes 2 major components
  221.      for all BBS types and an extra for BBS's using the RBBS-PC style
  222.      DORINFOx.DEF file.  The standard form is as such:
  223.  
  224.      CALLBACK <door type> <path to door file> [node]
  225.  
  226.      <door type> is any of the following:
  227.  
  228.                DORINFOx - RBBS/QuickBBS style DORINFOx.DEF file
  229.                JUMPER   - 2AM-BBS JUMPER.DAT file
  230.                CHAIN    - WWIV BBS CHAIN.TXT file
  231.                DOOR     - GAP BBS DOOR.SYS file
  232.                CALLINFO - Wildcat BBS CALLINFO.BBS file
  233.  
  234.      <path to door file> is the full path, including trailing backslash to
  235.      the directory where the door file is located.
  236.  
  237.      [node] is only needed if you are running a system with the
  238.      DORINFOx.DEF type of door interface file.
  239.  
  240.      4.0 Interfacing Callback
  241.  
  242.           Callback does not change the user's security level within any BBS
  243.      user files, this still remains the concern of the SysOp, or the
  244.      designated party.  Callback will exit with a DOS errorlevel of 1 if
  245.      the user was verified, and a DOS errorlevel of 0 if the verification
  246.      failed (long distance, no contact, or failed code reentry).
  247.  
  248.  
  249.  
  250.  
  251.      Callback V1.52                                                  Page 7
  252.  
  253.      4.1 With Maximus-CBCS
  254.  
  255.           Included in this archive is a file named MAXIMUS.xxx, this file
  256.      contains the .BBS and .MEC files that I use for interfacing Callback
  257.      and Maximus.  I have the two .BBS files (NOGOOD.BBS and GOOD.BBS)
  258.      located in my \MAX\ directory and this in my MAX.BTM (4DOS batch
  259.      file):
  260.  
  261.            .
  262.            .
  263.            .
  264.           if errorlevel 250 goto callback
  265.            .
  266.            .
  267.            .
  268.           :callback
  269.            callback.exe dorinfo e:\max\ 1
  270.            if errorlevel 1 goto verified
  271.            copy e:\max\nogood.bbs e:\max\misc\afterver.bbs
  272.            goto ONLINE_DOOR               { restart Maximus }
  273.           :verified
  274.            copy e:\max\good.bbs e:\max\misc\afterver.bbs
  275.            goto ONLINE_DOOR               { restart Maximus }
  276.  
  277.           You can see that if the user is verified, the AFTERVER.BBS file
  278.      in my \MAX\MISC\ directory will contain the MECCA commands to increase
  279.      the user's security level.  If not, the the NOGOOD.BBS file will be
  280.      displayed.
  281.  
  282.           Calling Callback from a MECCA file, you can use these MECCA
  283.      commands, as long as the file that calls them are located after the
  284.      NEWUSER2 file is displayed to the user:
  285.  
  286.           [link]Misc\dorinfo
  287.  
  288.           [Dequal][xtern_erlvl]250
  289.           [Nline][goto end]
  290.           [link]Misc\AfterVer
  291.           [label end]
  292.  
  293.  
  294.  
  295.  
  296.      Callback V1.52                                                  Page 8
  297.  
  298.      4.2 With RBBS-PC 17.x and up
  299.  
  300.           The archive labeled RBBS.xxx will contain only one file,
  301.      CALLRBBS.CFG, this file contains only one command word, ADD2SECLVL.
  302.      The value following this command word will be ADDED to the new users
  303.      existing security level.  If this file (CALLRBBS.CFG) is located in
  304.      the same directory as CALLBACK.EXE and you are using the DORINFO
  305.      command line parameter, Callback will make the file DOUTx.DEF in the
  306.      directory specified on the command line.  This file is used by RBBS-PC
  307.      to change the current user's security level.
  308.  
  309.           You enter CALLBACK.EXE in parameter 107 in the RBBS-PC
  310.      configuration program if all your Callback files are in the RBBS-PC
  311.      default directory.  If not, you will have to write a batch file to
  312.      change to your Callback directory.
  313.  
  314.      4.3 With XBBS
  315.  
  316.           If you are using the XBBS package, you can include these lines in
  317.      your WELCOME.XBS file (REMEMBER the @ symbol represents the 0x01
  318.      character {little smily face} ):
  319.  
  320.           @S>90 lUserOK
  321.           @X0
  322.           @ESCALLBACK.EXE dorinfo e:\xbbs\ 1
  323.           @e==1 lVerified
  324.  
  325.           Sorry @uN, but you have not been verified.
  326.           @blUserOK
  327.           @lVerified
  328.           @-910-010
  329.  
  330.           Congrats @uN, you have been verified.
  331.           @lUserOK
  332.  
  333.           This checks the user's #9 security level, if it is grater than 0,
  334.      the user has already been verified, and the callback is skiped.  If
  335.      not, Callback is called (without unloading XBBS) and ran, if the user
  336.      is sucssesfully verified, security level #9 is changed to 10, and
  337.      security level #0 is changed to 10.
  338.  
  339.           If you have tight memory requirements, you can use the @EE
  340.      function to run Callback from the .XBS file.
  341.  
  342.      4.4 Other BBS Systems
  343.  
  344.           Callback was made so it could run off of a variaty of BBS
  345.      systems, unfortunatly I have currently only ran three types of BBS
  346.      packages.  If you are running a BBS package not currently listed, you
  347.      could send me the type, version, and how you interfaced Callback with
  348.      your system, I will include your adaptation in the next release.
  349.  
  350.  
  351.  
  352.      Callback V1.52                                                  Page 9
  353.  
  354.      5.0 SysOp Keys
  355.  
  356.           The local keyboard has 6 special function keys for use by the
  357.      Sysop, they are as follows:
  358.  
  359.           F1 - Displays a small menu of the local keys (local only)
  360.  
  361.           F3 - Raise the users online time by 1 minute.
  362.  
  363.           CTRL F3 - Raise the users online time by 5 minutes.
  364.  
  365.           F4 - Lower the users onlint time by 1 minute.
  366.  
  367.           CTRL F4 - Lower the users online time by 5 minutes.
  368.  
  369.           ALT C - Enter/Exit Chat with the user.
  370.  
  371.      6.0 Conclusion
  372.  
  373.           If you have any questions, suggestions, or comment's feel free to
  374.      contact me at one of the addresses on the cover or via my BBS.  If you
  375.      wish, send me a copy of the BBS file you want Callback to work with
  376.      and I will modify the next version.
  377.  
  378.      7.0 Registration
  379.  
  380.           Just fill out the form on the next page and mail it to:
  381.  
  382.                         Robert Goshko
  383.                         c/o Axis Developments
  384.                         3408 - 105 Avenue
  385.                         Edmonton, Alberta
  386.                         T5W 0B4
  387.                         Canada
  388.  
  389.  
  390.  
  391.      Callback V1.52                                                 Page 10
  392.  
  393.                    Callback Registration Form - Version 1.52
  394.  
  395.                     P L E A S E   P R I N T   O R   T Y P E
  396.  
  397.  
  398.        SysOp Name : ______________________________________________________
  399.  
  400.          BBS Name : ______________________________________________________
  401.  
  402.      BBS Software : ______________________________________________________
  403.  
  404.        BBS Number : (_______) _______ - __________
  405.  
  406.      Voice Number : (_______) _______ - __________
  407.  
  408.           Address : ______________________________________________________
  409.  
  410.         City/Town : ______________________________________________________
  411.  
  412.          Province : ____________________
  413.  
  414.       Postal Code : ____________________
  415.  
  416.      Are you a member of Fidonet [_] or RBBSNet [_]  (Check All That Apply)
  417.  
  418.      FidoNet Address : _______________    RBBSNet Address : _______________
  419.  
  420.      Registration Method:
  421.  
  422.      ___ $11.00 Registration Key Sent Via Netmail ............  ____.______
  423.                  (Just the key file)
  424.  
  425.      ___ $13.00 Registration Key Sent Via Canada Post ........  ____.______
  426.                  (Latest Version of Callback & key file)
  427.  
  428.      ___ $15.00 Registration Key Sent Via Netmail ............  ____.______
  429.                  (Latest Version of Callback & key file)
  430.  
  431.                                                         Total = ____.______
  432.  
  433.      Payment Method:     Cheque [_]     Money Order [_]         (Check One)
  434.  
  435.  
  436.  
  437.      Signature __________________________________________  Date ___/___/___
  438.  
  439.